Developer --> Technical Publications

 


Introduction

This document introduces the Keychain Manager for Carbon and Classic applications. You can use the Keychain Manager to provide secure storage for a user's passwords, keys, and certificates. The Keychain Manager provides a uniform way to handle passwords for multiple users, multiple databases, or any situation in which a user must enter single or multiple passwords.

Your application should use Keychain Manager if your application normally requires the user to enter a password for access to some document or service. You don't need special knowledge of authentication schemes to use this document, though you should be familiar with the use and storage of passwords.

This document describes the Keychain Manager in the following sections:

  • "Keychain Manager Concepts" provides a conceptual overview of the Keychain Manager.
  • "Keychain Manager Tasks" provides an introduction to programming the Keychain Manager.
  • "Keychain Manager Reference" provides a complete description of the Keychain Manager 2.0 API, including its functions, data types, constants, and result codes.
  • "API and Document Revision History" provides a history of changes to this document, as well as changes to the Keychain Manager API from version 1.0.1 to 2.0.
  • Many aspects of Keychain Manager work in a similar way for Carbon, Classic, and Cocoa applications. For example, under Mac OS X, any type of application can call Keychain Manager.

    All code listings in this document are shown in C, except for listings that describe resources, which are shown in Rez-input format. Many listings are taken from the MenuScripter sample application, which is available through Apple's developer website at

    <http://developer.apple.com/>

    Important

    Although the sample code in this document has been compiled and tested to some degree, Apple Computer does not recommend that you directly incorporate this code into your application. For example, only limited error handling is shown--you should develop your own techniques for detecting and handling errors.

    Keychain Manager Concepts

    Keychain Manager Tasks

    API and Document Revision History


    © 2000 Apple Computer, Inc. (Last Updated 07 April 00)